home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / langs / clisp-c.zoo / README < prev    next >
Encoding:
Text File  |  1993-06-05  |  4.1 KB  |  152 lines
  1. This is CLISP, a Common Lisp implementation.
  2.  
  3.  
  4. What is LISP?
  5. -------------
  6.  
  7. LISP is a programming language. It was invented by J. McCarthy in 1959.
  8. There have been many dialects of it, but nowadays LISP has been standardized
  9. and wide-spread due to the industrial standard COMMON LISP. There are
  10. applications in the domains of symbolic knowledge processing (AI), numerical
  11. mathematics (MACLISP yielded numerical code as good as FORTRAN), and
  12. widely used programs like editors (EMACS) and CAD (AUTOCAD).
  13. There is an introduction to the language:
  14.  
  15.   Sheila Hughes: Lisp. Pitman Publishing Limited, London 1986.
  16.   107 pages.
  17.  
  18. After a while wou will need the standard text containing the language
  19. definition:
  20.  
  21.   Guy L. Steele Jr.: Common Lisp - The Language. Digital Press.
  22.   1. edition 1984, 465 pages.
  23.   2. edition 1990, 1032 pages.
  24.  
  25. LISP is run in an interactive environment. You input forms, and they will be
  26. evaluated at once. Thus you can inspect variables, call functions with given
  27. arguments or define your own functions.
  28.  
  29.  
  30. Contents:
  31. ---------
  32.  
  33. It consists of the following files:
  34.  
  35.       lisp.prg         main program
  36.       lispinit.mem     memory image needed for startup
  37.       clisp.1          manual page in Unix man format
  38.       clisp.man        manual page
  39.       impnotes.txt     implementation notes
  40.       README           this text
  41.       SUMMARY          short description of CLISP
  42.       ANNOUNCE         announcement
  43.       COPYRIGHT        copyright notice
  44.       GNU-GPL          free software license
  45.       config.lsp       site-dependent configuration
  46.  
  47. and - to your convenience, if you like reading source -
  48.  
  49.       *.lsp            the source of lispinit.mem
  50.       *.fas            the same files, already compiled
  51.  
  52.  
  53. Hardware requirements:
  54. ----------------------
  55.  
  56. This Atari version of CLISP requires an Atari ST with 68000 CPU and
  57. at least 2 MB of RAM.
  58.  
  59.  
  60. Installation:
  61. -------------
  62.  
  63. Edit the contents of config.lsp appropriately for your site,
  64. especially the definitions of short-site-name and long-site-name.
  65. You may also want to edit the time zone definition in defs1.lsp.
  66. Then start
  67.  
  68.          lisp.prg -M lispinit.mem
  69.  
  70. When the LISP prompt
  71.  
  72.       > _
  73.  
  74. appears, type
  75.  
  76.         (compile-file "config")
  77.         (load "config")
  78.  
  79. and - in case you modified defs1.lsp -
  80.  
  81.         (compile-file "defs1")
  82.         (load "defs1")
  83.  
  84. and then
  85.  
  86.         (saveinitmem)
  87.  
  88. to overwrite the file lispinit.mem with your configuration. Then
  89.  
  90.         (exit)
  91.  
  92. Then create a directory, and put the executable and the memory image there.
  93.  
  94.  
  95.  
  96. When you encounter problems:
  97. ----------------------------
  98.  
  99. After errors, you are in the debugger:
  100.  
  101.      1. Break> _
  102.  
  103. You can evaluate forms, as usual. Furthermore:
  104.  
  105.      Help
  106.                calles help
  107.      Abort     or
  108.      Unwind
  109.                climbs up to next higher input loop
  110.      (show-stack)
  111.                shows the contents of the stack, helpful for debugging
  112.  
  113. And you can look at the values of the variables of the functions where the
  114. error occurred.
  115.  
  116. On bigger problems, e.g. bombs, please send a description of the error
  117. and how to produce it reliably to the authors.
  118.  
  119.  
  120. Mailing List:
  121. -------------
  122.  
  123. There is a mailing list for users of CLISP. It is the proper forum for
  124. questions about CLISP, installation problems, bug reports, application
  125. packages etc.
  126.  
  127. For information about the list and how to subscribe it, send mail to
  128. listserv@ma2s2.mathematik.uni-karlsruhe.de, with the two lines
  129.           help
  130.           information clisp-list
  131. in the message body.
  132.  
  133.  
  134. Acknowledgement:
  135. ----------------
  136.  
  137. We are indebted to
  138.   * Guy L. Steele and many others for the Common Lisp specification.
  139.   * Richard Stallman's GNU project for GCC.
  140.  
  141.  
  142. Authors:
  143. --------
  144.  
  145.         Bruno Haible                    Michael Stoll
  146.         Augartenstraße 40               Gallierweg 39
  147.     D - W 7500 Karlsruhe 1          D - W 5300 Bonn 1       until 30 June 1993
  148.     D - 76137 Karlsruhe             D - 53117 Bonn          from 1 July 1993 on
  149.         Germany                         Germany
  150.  
  151. Email: haible@ma2s2.mathematik.uni-karlsruhe.de
  152.